This is the "Trouble_Shooting.txt" file distributed with
MG-SOFT MIB Browser Professional Edition.

Copyright (C) 1995-2024  MG-SOFT Corporation.
All rights reserved.

========================================================================
Table of Contents
-----------------

1. MIB Browser does not receive SNMP notifications because of a firewall
2. MIB Browser does not receive SNMP notifications because some other process
   is occupying the trap port(s)
3. MIB Browser's splash screen displayed longer than usually
4. General guidelines for reporting the problem


==========================================================================
1. MIB Browser does not receive SNMP notifications because of a firewall
--------------------------------------------------------------------------

Problem Description
-------------------
If there is a firewall on the PC running MIB Browser (e.g., the built-in
Windows Firewall or a third-party software firewall), or if there is a
firewall between that PC and the network nodes that send SNMP notifications
to MIB Browser, the firewall might be blocking traffic on the default
trap ports (IP/UDP 162 and IPv6/UDP 162). Consequently, MIB Browser does
not receive SNMP notifications sent from remote devices.

Symptoms
--------
MIB Browser does not receive any SNMP notifications sent to it from remote
SNMP agents, although the status of the default trap port (IP/UDP 162)
in the MIB Browser Preferences dialog box, Trap Ringer/Ports view is listed
as "Ready" and MIB Browser can receive Traps sent locally to the loopback 
interface (127.0.0.1).

Solution
--------
Open the appropriate port(s) on the firewall (IP/UDP 162 and IPv6/UDP 162)
to allow passing SNMP Trap and Inform packets through. For instructions
on configuring the firewall, kindly refer to documentation that came
with it.


============================================================================
2. MIB Browser does not receive SNMP notifications because some other 
   process is occupying the trap port(s)
----------------------------------------------------------------------------

Problem Description
-------------------
If some third-party application other than Microsoft "SNMP Trap Service" 
opens the default trap port (IP/UDP 162) before MIB Browser (actually its 
trap receiving service - "MG-SOFT SNMP Trap Service"), then MIB Browser will 
not be able to receive any SNMP Trap and Inform messages on default trap port.

Symptoms
--------
On startup MIB Browser displays the following message in the Query results 
window panel: "Failed to register trap reception on default port 162".
Consequently, MIB Browser does not receive any SNMP notifications on 
the default port, although MG-SOFT SNMP Trap Service is running. 

Solution
--------
First, please check the  status of the default trap port (IP/UDP 162) in 
MIB Browser. To do this, open the MIB Browser Preferences dialog box from
the View menu and switch to the Trap Ringer/Ports view. If the status of
the IP/UDP port 162 is listed as "Down", then probably some other trap 
receiving application/process running on the same computer is occupying 
this port and and because of that MIB Browser (actually, MG-SOFT SNMP Trap
Service - MgWTrap3.exe) cannot bind to that port to receive SNMP Trap/Inform
messages.

To check this, open a CMD window as *administrator* and execute the 
following command in it:

     netstat -anobp udp

This command  prints out  all occupied  UDP ports. If it prints two lines 
like this:

     UDP    0.0.0.0:162            *:*               1852 
     [some application]

...then  it means  that the  process whose  name is  listed in  square 
brackets (and  which has  processID 1852 in this example) occupies 
UDP/IPv4 port 162. If the name of the process is OTHER than "MgWTrap3.exe" 
or "snmptrap.exe", then you should terminate such process (also make sure
it won't be restarted at the next system reboot!). 

Then, open the Services window (Start->Run:services.msc) and restart 
the MG-SOFT SNMP Trap Service (MgWTrap3.exe). Finally, restart 
MIB Browser application and check if the problem is solved.

Check again the status of IP/UDP port 162 in MIB Browser Preferences
dialog (CTRL+R), Trap Ringer/Ports view (its status should be "Ready").

Finally, check if MIB Browser can now receive Traps by sending a test
Trap to it using the bundled sendtrap.exe utility. To do that, open
the CMD window (Start->Run:CMD), change directory to
"C:\Program Files\MG-SOFT\MIB Browser\Bin"
and execute the following command:

  sendtrap 127.0.0.1

The Trap Ringer Console window should display a new Trap message.


========================================================================
3. MIB Browser's splash screen displayed longer than usually
------------------------------------------------------------

Problem Description
-------------------

Sometimes, MIB Browser cannot properly initialize a notifications
receiving module at startup. In this case the program startup takes
longer than usually. This behavior is mostly related to the
Microsoft's SNMP Trap service.

Symptoms
--------

The MIB Browser's splash screen, which is normally shown only for
a few seconds at the program startup, remains displayed for a few
minutes showing a notice 'Registering Notifications...'.

Solution
--------

Check if you have the Microsoft's SNMP Trap service running or not.
If not, set the service to 'Automatic' startup at boot time (or
disable it, if you do not need it), but do NOT configure it for
'Manual' startup.

Also, if you installed Microsoft SNMP service when a certain service
pack was already installed on that computer, you must re-apply
the same (or newer) service pack. Otherwise, the newly installed SNMP
Service may not function properly.


========================================================================
4. General guidelines for reporting the problem
-----------------------------------------------

Before reporting the problem, make sure that you are using the latest
version of the software as available from MG-SOFT's download page at
https://www.mg-soft.com/download.html. Report the problem only in case
you can reproduce it by using the latest version of the software and
you cannot find a suitable problem solution description in this document.

In order to receive a prompt and accurate response from the support
team, provide the following information when reporting a problem:

 1. For which software title are you reporting the problem?

 2. Are you using the licensed or evaluation version of the
    software? If licensed, attach the SERIAL.TXT file that you
    received with the license.key file when you licensed the
    software.

 3. In the application, select the "Help|Support" command from the
    main menu and e-mail us the complete output of that function.

 4. Which operating system are you using (Windows 7, Windows 
    Server 2008, Windows Server 2012, Windows 8.x, Windows 10, 
    Windows Server 2016, Windows Server 2019, Windows 11, etc.)? 
    Which service pack is installed on that operating system?

 5. Did you install the software as Administrator?
    Do you have administrative privileges when running the software?

 6. Do you have any other SNMP or network management software
    installed on that computer? Or any other kind of software
    that may interfere with MG-SOFT's software. If yes, which?

 7. Can you reproduce the problem on any other computer?
    What is the operating system running on the other computer?

 8. Describe the exact step-by-step procedure to reproduce
    the problem.

 9. When reporting problems related to MIB Compiler (i.e.,
    when you are unable to compile a MIB file), zip the MIB file
    and all MIBs that are imported by the MIB, and e-mail the zip
    file along with your support application.

10. Do you have a firewall running on your PC or on your
    network that is blocking certain TCP and UDP ports, which
    could prevent normal operation of MG-SOFT's software products?

Please e-mail answers to the above questions to <support@mg-soft.si>.


========================================================================
